Built-in Tests
The 3DM-GQ7 provides users two types of built-in tests (BIT) for verifying its proper operation: the continuous BIT and the commanded BIT. The results for both tests are sent in the response packets to the respective commands.
Commanded Built-in Test
Command
Description
The commanded BIT is a disruptive process which pauses normal operation and performs a series of tests on various system components. The primary purpose of this command is to verify that the IMU sensors are operating normally; however, other tests are also conducted. See the table below for a complete description.
It may take several seconds for this command to complete. During this time, 3DM-GQ7 data will be unavailable.
IMPORTANT: The IMU sensors can report false failures if the system is subjected to significant acceleration, rotation, or vibration during this test. Therefore, it is advised that users only run this test when the 3DM-GQ7 is at rest.
NOTE: For some errors, the continuous BIT provides more detail than the commanded BIT. Therefore, a continuous BIT executed after a commanded BIT may offer additional insight into a commanded BIT failure.
The commanded BIT is formatted as a single uint32 bitfield.
| Bit(s) | Error | Notes |
|---|---|---|
| 0 | General Hardware Fault | A critical hardware component, such as the internal oscillator, has failed or is not operating properly. |
| 1 | General Firmware Fault | System firmware has detected a serious unexpected or abnormal condition. |
| 2 | Timing Overload | The system is unable to keep up with the processing demand. Usually this is a result of turning on too many features at once, such as streaming too many descriptors. This bit resets after this command is processed. |
| 3 | Buffer Overrun | A data buffer in the system has reached its capacity. Usually this means the connection bandwidth has been exceeded by streaming too much data. |
| 4-7 | Reserved | |
| 8 | IMU IPC Fault | The IMU subsystem is unresponsive or not operating normally. |
| 9 | Filter IPC Fault | The Filter subsystem is unresponsive or not operating normally. |
| 10 | GNSS IPC Fault | The GNSS subsystem is unresponsive or not operating normally. |
| 11 | Communications System Fault | There is a problem with the communciations subsystem. |
| 12 | Accelerometer Fault | The accelerometer has been damaged or is inoperative. |
| 13 | Gyroscope Fault | The gyroscope has been damaged or is inoperative. |
| 14 | Magnetometer Fault | The magnetometer has been damaged or is inoperative. |
| 15 | Pressure Sensor Fault | The pressure sensor has been damaged or is inoperative. |
| 16-17 | Reserved | |
| 18 | Calibration Error | The IMU calibration is invalid. |
| 19 | General IMU Fault | A problem has been detected in the IMU subsystem. This bit is only for miscellaneous error conditions and will not necessarily be flagged along with other faults. |
| 20-21 | Reserved | |
| 22 | Filter Solution Fault | The filter solution is invalid. This bit will be set if a NaN appears in the filter output. The filter should be reset if this occurs. |
| 23 | General Filter Fault | A problem has been detected in the filter subsystem. This bit is only for miscellaneous error conditions and will not necessarily be flagged along with other faults. |
| 24 | GNSS Receiver 1 Fault | Receiver 1 is inoperative or is not reporting valid data. |
| 25 | GNSS Antenna 1 Fault | The antenna for receiver 1 is disconnected (open) or shorted. |
| 26 | GNSS Receiver 2 Fault | Receiver 2 is inoperative or is not reporting valid data. |
| 27 | GNSS Antenna 2 Fault | The antenna for receiver 2 is disconnected (open) or shorted. |
| 28 | RTCM Communcation Fault | RTCM data was being received previously but is not currently being received. |
| 29 | RTK Dongle Fault | A problem has been detected with the RTK dongle. Query it directly for more details. |
| 30 | Reserved | |
| 31 | General GNSS Fault | A problem has been detected in the GNSS subsystem. This bit is only for miscellaneous error conditions and will not necessarily be flagged along with other faults. |
Continuous Built-in Test
Command
Continuous Built-In Test (0x01,0x08)
Data Message
Continuous Built-In Test (0xA0,0x01)
Description
The continuous BIT reports the status of various internal flags which are continuously updated. The Continuous BIT command is not disruptive.
The continuous BIT results are also available to stream as a data message. Any BIT flags that go high between messages are not cleared until after the next message is sent. Due to its size, it is recommended to stream this message at low rates.
The sensor over-range flags are also available in a smaller message which provides results for individual axes and is better suited for high rate streaming. See the Overrange Status (0x80,0x18) message for details.
NOTE: Some of the continuous BIT flags are only updated when the commanded BIT is executed. For best results, conduct a commanded BIT at least once prior to monitoring the continuous BIT.
The continuous BIT is formatted as 16 - uint8 bitfields.
| Bit(s) | Relative Index (Byte.Bit) |
Error | Notes |
|---|---|---|---|
| 0 | 0.0 | System Clock Failure | The system clock is not operating properly. Timing may not be accurate and the system may be unreliable. |
| 1 | 0.1 | Power Fault | Power supply voltage is outside of the recommended range, or an internal power fault exists. |
| 2 | 0.2 | Reserved | |
| 3 | 0.3 | Reserved | |
| 4 | 0.4 | Firmware Fault | System firmware has detected an unexpected or abnormal condition. |
| 5 | 0.5 | Timing Overload | The system is unable to keep up with the processing demand. Usually this is a result of turning on too many features at once, such as streaming too many descriptors. This bit resets after this command is processed. |
| 6 | 0.6 | Buffer Overrun | A data buffer in the system has reached its capacity. Usually this means the connection bandwidth has been exceeded by streaming too much data. |
| 7-15 | 0.7-1.7 | Reserved | |
| 16-19 | 2.0-2.3 | IMU IPC Fault | The IMU subsystem is unresponsive or not operating normally. |
| 20-23 | 2.4-2.7 | Filter IPC Fault | The Filter subsystem is unresponsive or not operating normally. |
| 24-27 | 3.0-3.3 | GNSS IPC Fault | The GNSS subsystem is unresponsive or not operating normally. |
| 28-31 | 3.4-3.7 | System Reserved | |
| 32 | 4.0 | IMU Clock Fault | This subsystem is not running off the system clock. |
| 33 | 4.1 | IMU Communication Fault | No communication with subsystem. |
| 34 | 4.2 | IMU Timing Overrun | Internal processes are taking longer than their allotted time. |
| 35 | 4.3 | IMU Reserved | |
| 36 | 4.4 | IMU Calibration Error - Accel | A problem is detected with the accelerometer calibration. |
| 37 | 4.5 | IMU Calibration Error - Gyro | A problem is detected with the gyroscope calibration. |
| 38 | 4.6 | IMU Calibration Error - Mag | A problem is detected with the magnetometer calibration. |
| 39 | 4.7 | IMU Calibration Error - Reserved | |
| 40 | 5.0 | Accelerometer General Fault | Sensor won't initialize. |
| 41 | 5.1 | Accelerometer Over-range | One or more axes subjected to accelerations near or outside the selected range. |
| 42 | 5.2 | Accelerometer Self-test Fail | The internal self-test of the sensor failed. |
| 43 | 5.3 | Accelerometer Reserved | |
| 44 | 5.4 | Gyroscope General Fault | Sensor won't initialize. |
| 45 | 5.5 | Gyroscope Over-range | One or more axes subjected to rotational rates near or outside the selected range. |
| 46 | 5.6 | Gyroscope Self-test Fail | The internal self-test of the sensor failed. |
| 47 | 5.7 | Gyroscope Reserved | |
| 48 | 6.0 | Magnetometer General Fault | Sensor won't initialize. |
| 49 | 6.1 | Magnetometer Over-range | One or more axes subjected to magnetic fields strengths near or outside the supported range. |
| 50 | 6.2 | Magnetometer Self-test Fail | The internal self-test of the sensor failed. |
| 51 | 6.3 | Magnetometer Reserved | |
| 52 | 6.4 | Pressure Sensor General Fault | Sensor won't initialize. |
| 53 | 6.5 | Pressure Sensor Over-range | Pressure sensor subjected to pressures outside of the supported range. |
| 54 | 6.6 | Pressure Sensor Self-test Fail | The internal self-test of the sensor failed. |
| 55 | 6.7 | Pressure Sensor Reserved | |
| 56-63 | 7.0-7.7 | IMU Reserved | |
| 64 | 8.0 | Filter Clock Fault | This subsystem is not running off the system clock. |
| 65 | 8.1 | Filter Hardware Fault | Hardware initialization error. |
| 66 | 8.2 | Filter Timing Overrun | Internal processes are taking longer than their allotted time. |
| 67 | 8.3 | Filter Timing Underrun | Internal processes are being skipped. |
| 68-71 | 8.4-8.7 | Filter Communication Error | No communication with subsystem. |
| 72-95 | 9.0-11.7 | Filter Reserved | |
| 96 | 12.0 | GNSS Clock Fault | This subsystem is not running off the system clock. |
| 97 | 12.1 | GNSS Hardware Fault | Hardware initialization error. |
| 98-100 | 12.2-12.4 | GNSS Comunication Error | No communication with subsystem |
| 101 | 12.5 | GPS Time Fault | System GPS Time is invalid. |
| 102 | 12.8 | GNSS Timing Overrun | Internal processes are taking longer than their allotted time. |
| 103 | 12.7 | GNSS Reserved | |
| 104 | 13.0 | GNSS Receiver 1 Power Fault | Internal power fault. |
| 105 | 13.1 | GNSS Receiver 1 Fault | Receiver 1 is inoperative. |
| 106 | 13.2 | GNSS Antenna 1 Shorted | Antenna 1 is shorted to ground. |
| 107 | 13.3 | GNSS Antenna 1 Open | Antenna 1 is open-circuit (or DC block is installed) |
| 108 | 13.4 | GNSS Receiver 1 Solution Fault | Receiver 1 solution is invalid. |
| 109 | 13.5 | GNSS Receiver 2 Power Fault | Internal power fault. |
| 110 | 13.6 | GNSS Receiver 2 Fault | Receiver 2 is inoperative. |
| 111 | 13.7 | GNSS Antenna 2 Shorted | Antenna 2 is shorted to ground. |
| 112 | 14.0 | GNSS Antenna 2 Open | Antenna 2 is open-circuit (or DC block is installed) |
| 113 | 14.1 | GNSS Receiver 2 Solution Fault | Receiver 2 solution is invalid. |
| 114 | 14.2 | RTCM Communication Fault | RTCM data was being received previously but is not currently being received. |
| 115 | 14.3 | RTK Dongle Fault | A problem has been detected with the RTK dongle. Query it directly for more details. |
| 116-127 | 14.4-15.7 | GNSS Reserved |